FundLevels Element

The FundLevels transaction element provides a set of conditions that identify the child funds' or lateral funds' relationship to parent funds. This is relevant to Activities because Allocations must identify Parent level funds and trading (movement of money as investments or withdrawals) must identify specific Child or Lateral fund levels. Definition of this relationship is required in any Activity that trades units into and out of funds that have these child and lateral funds, otherwise, there is no impact.

FundLevels: Elements and Attributes
Element Parent Element Attribute Definition
<FundLevels> <Transaction>   Optional:
This element is a structure to define the relationships between fund levels. This pertains to unit based funds only and is ignored for other funds.

<FundLevel>

 

 <FundLevels>

 

Required, Repeatable:

This element identifies the fund level that is being defined.
 

LEVEL

Required   

This attribute identifies the fund level to be used by money movement.

Values:

  • Parent

    • default

    • This is the natural relationship in an activity's money movement. There are no related funds and the fund ids in allocations are directly impacted by money movement.

  • Child

    • There is a child relationship to the variable funds provided by Allocation.

  • Lateral

    • There is a child relationship to the unitized fixed funds provided by Allocation.

<Relation>

 <FundLevel>

 

Optional

This section contains the instructions to relate the parent funds in allocations to the actual funds used in assignments. Multiple relations may be necessary to identify the single child or lateral fund.

This element is required when the LEVEL attribute is Child or Lateral.

This element is ignored when the LEVEL attribute is Parent.

<Criteria>

 

 <Relation>

 

Required, Repeatable:

Each <Criteria> establishes a single relationship for Child and Lateral fund discovery. The value of this element is compared to a Fund's field to determine which of multiple related child funds to add or remove money. The element's value will often identify a Policy or Segment Field.

Values:

  • field

  • literal text
<Criteria>

NAME

Required:

The attribute provides the Fund's field name used in the match to establish a relationship.

Values:

  • field
<Criteria>

DATATYPE

Required:

The attribute provides the data type of the fund field and Policy field.

Values:

  • TEXT

  • DATE

  • INTEGER

  • DECIMAL

XML Schema

<Transaction>
...        
    <FundLevels>
        <FundLevel LEVEL="{Parent | Child | Lateral]">
            <Relation>
                <Criteria NAME="[field name]" DATATYPE="[TEXT | DATE | INTEGER | DECIMAL]">[variable name]</Criteria>
                <Criteria>...</Criteria>
            </Relation>
        </FundLevel>
        <FundLevel>...</FundLevel>
    </FundLevels>
...
</Transaction>

XML Example

<Transaction>
...        
    <FundLevels>
        <FundLevel LEVEL="Child">
            <Relation>
                <Criteria NAME="BandVariable" DATATYPE="TEXT">Policy:BandVariable</Criteria>
            </Relation>
        </FundLevel>
        <FundLevel LEVEL="Lateral">
            <Relation>
                <Criteria NAME="SubClass" DATATYPE="TEXT">Policy:SubClass</Criteria>
            </Relation>
        </FundLevel>
    </FundLevels>
...
</Transaction>